package cn.iocoder.yudao.module.written.exam.service.userwrittenexamrecordsdetail;

import java.util.*;
import javax.validation.*;

import cn.iocoder.yudao.module.written.exam.controller.admin.userwrittenexamrecordsdetail.vo.*;
import cn.iocoder.yudao.module.written.exam.controller.app.userwrittenexamrecordsdetail.vo.AppUserWrittenExamRecordsDetailGroupRespVO;
import cn.iocoder.yudao.module.written.exam.dal.dataobject.userwrittenexamrecordsdetail.UserWrittenExamRecordsDetailDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 笔试记录详情 Service 接口
 *
 * @author 芋道源码
 */
public interface UserWrittenExamRecordsDetailService {

    /**
     * 创建笔试记录详情
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createUserWrittenExamRecordsDetail(@Valid UserWrittenExamRecordsDetailSaveReqVO createReqVO);

    /**
     * 更新笔试记录详情
     *
     * @param updateReqVO 更新信息
     */
    void updateUserWrittenExamRecordsDetail(@Valid UserWrittenExamRecordsDetailSaveReqVO updateReqVO);

    /**
     * 删除笔试记录详情
     *
     * @param id 编号
     */
    void deleteUserWrittenExamRecordsDetail(Long id);

    /**
     * 获得笔试记录详情
     *
     * @param id 编号
     * @return 笔试记录详情
     */
    UserWrittenExamRecordsDetailDO getUserWrittenExamRecordsDetail(Long id);

    /**
     * 获得笔试记录详情
     *
     * @param recordsId 笔试记录编号
     * @return 笔试记录详情
     */
    List<UserWrittenExamRecordsDetailDO> getUserWrittenExamRecordsDetailByRecordsId(Long recordsId);

    /**
     * 获得笔试记录聚合信息
     *
     * @param recordsIds 笔试记录编号
     * @return 笔试记录详情
     */
    Map<Long, AppUserWrittenExamRecordsDetailGroupRespVO> groupByRecordsId(List<Long> recordsIds);

    /**
     * 获得笔试记录详情分页
     *
     * @param pageReqVO 分页查询
     * @return 笔试记录详情分页
     */
    PageResult<UserWrittenExamRecordsDetailDO> getUserWrittenExamRecordsDetailPage(UserWrittenExamRecordsDetailPageReqVO pageReqVO);

    /**
     * 获得用户最后一个笔试记录详情
     *
     * @param recordsId 笔试记录编号
     * @return 笔试记录详情
     */
    UserWrittenExamRecordsDetailDO getEndUserWrittenExamRecordsDetail(Long recordsId);

}